home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / editor / editor2 / hsc.lha / hsc / src_docs / bugs.hsc < prev    next >
Text File  |  1996-12-04  |  4KB  |  92 lines
  1. <WEBPAGE chapter="hsc - " title="Known Bugs, Problems and Limitations"
  2.     PREV="source.html"
  3.     NEXT="future.html"
  4.     QTEXT=("So we keep putting our trust in things that rust<BR>"
  5.           +"And then we feel the pain of loss")
  6.     QAUTHOR='James, "Stripmining"'>
  7.  
  8. <H2>Known bugs</H2>
  9.  
  10. The problems below should be fixed.. sometimes.
  11. <UL>
  12. <LI>For missing end-tags, the position of the last occurence of the
  13.     start-tag with the same name is reported as correspondig 
  14.     start-tag.
  15. <LI><CODE>exists()</CODE> does not work for absolute URIs
  16. <LI>There seems to be a problem with <CODE>GETSIZE</CODE> for
  17.     machines based on CPUs that do not support networking byte order
  18.     (like those from wIntel). 
  19. <LI>I'm still not sure, if <CODE>GETSIZE</CODE> for JFIF/JPEG can handle
  20.     everything correct - but hopefully it does. I've really never seen
  21.     such an idiotic, braindead, ill-minded and chaoticly structured 
  22.     image-format before.
  23. </UL>
  24.  
  25. <H2>Known problems (to be fixed)</H2>
  26.  
  27. The problems below are no real bugs and should be fixed.. sometimes.
  28. <UL>
  29. <LI>Most NEXT and PREV buttons of the  docs don't fit; I just wanted to
  30.     show how to create a navigation bar, but I'm too lazy to maintain it
  31.     while the structure of the documention isn't fixed.
  32. <LI>As I know myself, these documents still contain loads of typos and
  33.     <qq>strange english</qq>..
  34. </UL>
  35.  
  36. <H2>Known problems</H2>
  37.  
  38. The problems described below probably won't ever be fixed.
  39. <UL>
  40. <LI>URI checking is performed via trying to open a file. As AmigaOS
  41.     is case-insensitive dealing with filenames, problems might
  42.     occure when copying the html-object-tree to a case-sensitive
  43.     filesystem. I recommend to rebuild the whole project at the
  44.     target system.
  45. <LI>If you specify a <TG>BASE HREF=".."</TG>, <hsc> is unable to
  46.     find out how the base is related to the destination-directory
  47.     and will treat all local URIs like external ones; Absolute URIs
  48.     aren't possible with a base-URI set, of course.
  49. <LI>The obsolete tags <TG>LISTING</TG> and <TG>XMP</TG> might not be
  50.     treated correctly, as the behavior of these two seems so be not
  51.     very strickly definded. You should avoid them anyway and use
  52.     <TG>PRE</TG> or <TG>$source</TG> instead.
  53. <LI><hsc> doesn't care much about filenames and their limitations; 
  54.     if, for example, a filename gets too long, it depends on 
  55.     <CODE>fopen()</CODE> of your compiler whether an error is reported 
  56.     or the filename
  57.     is truncated. If you insist on filenames containig 46587643 
  58.     characters, <hsc> can cope with it - but your OS probably won't.
  59. <LI>Out-of-memory can cause small memory-leaks. This is because <hsc>
  60.     uses a special <CODE>malloc()</CODE>-function
  61.     which just displays an error message and quits using 
  62.     <CODE>exit()</CODE>. As <hsc> keeps track of all allocated resources,
  63.     it will release everything that could be fully initialised and made
  64.     it into its supposed resource-list. For out-of-memories during
  65.     partially initialising complex structures, this failes and can
  66.     cause memory-leaks (normally approx. 100-500 bytes). Usually, these
  67.     are handled by your OS or, as for AmigaOS, by the 
  68.     <CODE>malloc()</CODE>-function of the run-time-library, so you
  69.     shouldn't bother too much about that. Blame K&R for their braindamaged
  70.     memory-managment concepts.
  71. <LI><CODE>GetFileSize()</CODE> probalbly won't work correctly on
  72.     files greater than 2 GB.
  73. <LI>Until now I couldn't test <hsc> on some 64-bit OS, so problems
  74.     might occure if data leave 32-bit address-space.
  75. </UL>
  76.  
  77. <H2>Limitations</H2>
  78.  
  79. <P><hsc> is fully dynamic and it's input size, numer of syntax-elements
  80. and etc. is only limited by memory and disk-space. Only some less important
  81. status messages are created in classic, braindead zero-terminated 
  82. C-character-arrays and are truncated if they become too long.</P>
  83.  
  84. <P>However, for projects larger 500 documents, scanning the project-file on
  85. every run takes an awful lot of time; due the lack of any portable
  86. concept of keeping data resident after a program exits, there is
  87. no workaround for this (same problem like with <hsc.prefs>); you
  88. will have to get rid of the project-file and <hscdepp> for such
  89. projects.</P>
  90.  
  91. </WEBPAGE>
  92.